home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zpttrs.z / zpttrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          ZZZZPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZPTTRS - solve a system of linear equations A * X = B with a Hermitian
  10.      positive definite tridiagonal matrix A using the factorization A =
  11.      U**H*D*U or A = L*D*L**H computed by ZPTTRF
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE ZPTTRS( UPLO, N, NRHS, D, E, B, LDB, INFO )
  15.  
  16.          CHARACTER      UPLO
  17.  
  18.          INTEGER        INFO, LDB, N, NRHS
  19.  
  20.          DOUBLE         PRECISION D( * )
  21.  
  22.          COMPLEX*16     B( LDB, * ), E( * )
  23.  
  24. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  25.      ZPTTRS solves a system of linear equations A * X = B with a Hermitian
  26.      positive definite tridiagonal matrix A using the factorization A =
  27.      U**H*D*U or A = L*D*L**H computed by ZPTTRF.
  28.  
  29.  
  30. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  31.      UPLO    (input) CHARACTER*1
  32.              Specifies whether the superdiagonal or the subdiagonal of the
  33.              tridiagonal matrix A is stored and the form of the factorization:
  34.              = 'U':  E is the superdiagonal of U, and A = U'*D*U;
  35.              = 'L':  E is the subdiagonal of L, and A = L*D*L'.  (The two
  36.              forms are equivalent if A is real.)
  37.  
  38.      N       (input) INTEGER
  39.              The order of the tridiagonal matrix A.  N >= 0.
  40.  
  41.      NRHS    (input) INTEGER
  42.              The number of right hand sides, i.e., the number of columns of
  43.              the matrix B.  NRHS >= 0.
  44.  
  45.      D       (input) DOUBLE PRECISION array, dimension (N)
  46.              The n diagonal elements of the diagonal matrix D from the
  47.              factorization computed by ZPTTRF.
  48.  
  49.      E       (input) COMPLEX*16 array, dimension (N-1)
  50.              The (n-1) off-diagonal elements of the unit bidiagonal factor U
  51.              or L from the factorization computed by ZPTTRF (see UPLO).
  52.  
  53.      B       (input/output) DOUBLE PRECISION array, dimension (LDB,NRHS)
  54.              On entry, the right hand side matrix B.  On exit, the solution
  55.              matrix X.
  56.  
  57.      LDB     (input) INTEGER
  58.              The leading dimension of the array B.  LDB >= max(1,N).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          ZZZZPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      INFO    (output) INTEGER
  75.              = 0:  successful exit
  76.              < 0:  if INFO = -i, the i-th argument had an illegal value
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.